home *** CD-ROM | disk | FTP | other *** search
/ Aminet 19 / Aminet 19 (1997)(GTI - Schatztruhe)[!][Jun 1997].iso / Aminet / util / time / time_ma.lha / time.doc < prev   
Text File  |  1997-03-07  |  2KB  |  103 lines
  1. TIME - a program to measure the execution times of other commands
  2.  
  3. Documentation by Matthias Andree. See time.c for address.
  4.  
  5.  
  6.  
  7. Copyright:
  8.  
  9.   see time.c for information.
  10.   archive must be unchanged for redistribution.
  11.   no fees except reasonable media costs must be charged.
  12.   redistribution for non-profit purposes only.
  13.  
  14.   NO WARRANTIES. USE AT YOUR OWN RISK.
  15.  
  16.  
  17.  
  18. Requirements:
  19.  
  20.   OS 2.04 (V37) or newer.
  21.  
  22.  
  23.  
  24. Installation:
  25.  
  26.   copy it somewhere in your command path.
  27.  
  28.  
  29.  
  30. Usage:
  31.  
  32.   (shell only)
  33.  
  34.   SYNTAX:
  35.   -------
  36.   TIME [REPEAT <n>] [FAILAT <m>] COMMAND <command and arguments>
  37.  
  38.   TEMPLATE:
  39.   ---------
  40.   R=REPEAT/K/N,F=FAILAT/K/N,C=COMMAND/A/F
  41.  
  42.  
  43.   KEYWORDS:
  44.   ---------
  45.  
  46.   REPEAT: (optional, keyword must be specified, defaults to 1)
  47.  
  48.     tells Time how often it it supposed to issue the command. The higher
  49.     this value, the higher the accuracy.
  50.  
  51.   FAILAT: (optional, keyword must be specified, defaults to 10)
  52.  
  53.     tells Time what return code should be considered a "FAIL". The  time
  54.     that the command took is only shown if the command did not fail.
  55.  
  56.   COMMAND: (mandatory, rest of line)
  57.  
  58.     tells what command and options are to be  used.  Please  enclose  in
  59.     double  quotes  if  you want to specify input/output redirection for
  60.     the command to be issued. Input and output default to NIL:
  61.  
  62.  
  63.   EXAMPLES:
  64.   ---------
  65.  
  66.   TIME REPEAT=17 FAILAT=21 COPY S:STARTUP-SEQUENCE RAM:
  67.  
  68.   TIME SORT ADRESSES.TXT
  69.  
  70.  
  71.  
  72.   Time suppresses any "insert volume xxx: into any  drive"  and  similar
  73.   system requesters.
  74.  
  75.   The output of the command that is to be checked is redirected to  NIL:
  76.   by default. If you still want to see it, type e. g.
  77.  
  78.     TIME "TYPE S:STARTUP-SEQUENCE >CONSOLE:"
  79.  
  80.   that means enclose the command in quote marks and add a redirection to
  81.   *, PRT:, CONSOLE: or wherever else you like it.
  82.  
  83.  
  84.  
  85. Development environment:
  86.  
  87.   SAS/C 6.57 by SAS Institute, Inc.
  88.   GoldEd 4.5.1 by Dietmar Eilert
  89.  
  90.  
  91.  
  92. History:
  93.  
  94.   See time.c for history
  95.  
  96.  
  97.  
  98. Regards to:
  99.  
  100.   Stefano Reksten    for time v1.2
  101.   Oliver B. Warzecha
  102.   Stefan Ruppert     for bug reports
  103.